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What is SDMX? 
Includes: An explanation of SDMX (Statistical Data and Metadata Exchange) 


ABS.Stat SDMX Web Service 


Includes: An outline on the purpose of the ABS.Stat web service and how it operates including SDMX web services 
methods. 


Information for building a custom .Net application to call SDMX Web Service 
Includes: Details on how to build a simple C# .NET application that calls the SDMX web services. 


Frequently Asked Questions 
Includes: Information on dataset availability, coding and errors. 
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é 
FY What is SDMX? 


SDMxX stands for Statistical Data and Metadata Exchange - the electronic exchange of statistical 
information. It is an initiative that aims to foster common standards and guidelines for the exchange and 
sharing of statistical data and metadata, where the two are presented together, with an emphasis on 
aggregated data. Metadata gives context to the data exchanged, so information is immediately 
understandable and more useful than if it was presented without the relevant metadata. SDMX can be used 


within and between national statistical offices, central banks, ministries and other bodies, both nationally and 
internationally. 


Common standards and guidelines created by SDMX enable easy access to statistical data and makes data 
more comparable, more meaningful and generally more usable. 


(For more information about SDMX please refer to the SDMX website). 
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Z ABS.Stat SDMX Web Service 


General Overview 


Service Consumer Service Provider 


ABS. Stat SDMX Web Service 


machine / device / customer 


Figure 1: General overview of ABS.Stat SDMX Web Service 

The purpose of the ABS.Stat SDMX Web Service is to provide a mechanism for automatic 
transfer of data between machines for the dissemination of ABS data. 

SDMxX is the agreed standard (common language) for the transfer of statistical data between 
machines. 


Technical Overview 


Query 


Figure 2 : How ABS. Stat SDMX web service works 


Web Service 
Function Call 


From the above diagram (Figure 2), a query message is created by the user with the necessary 
selection criteria to obtain the specific piece of data the user requires. 

The query message is then submitted to the SDMX web service via a web service function \ 
method call which in return provides an SDMX-formatted output file. 

Different query messages will be required for different web service method calls. 


Access to ABS.Stat SDMX Web Service 


Access to ABS.Stat SDMX web service is through the following url address: 


Owner Url to Web service Comments 


ABS http://stat.abs.gov.au/sdmxws/sdmx.asmx |This service is made 
available as a part of ABS 
Betaworks and can be 
used for research and 
testing purposes only. 
Please refer to 
www.abs.gov.au for official 
data. 
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SDMX Web Service Methods: 
There are 9 SDMX WS methods that will be made available, these are: 


e GetGenericData 

e GetCompactData 

e GetDataStructureDefinition 

e GetDatasetMetadata 

e GetDimensionMemberMetadata 
e GetDimensionMetadata 

e GetMetadata 

e GetMetadataStructure 

e GetReferenceMetadata 


1. GetGenericData 

This method retrieves data in a generic format from a specified ABS.Stat dataset. It requires an input 
parameter (ie the query) as an XML document in SDMX-ML format. An example of the GetGenericData 
SDMX query message is copied on the following page. The Web Service will return the query results in 
SDMX-ML format (see SDMX query result example below). 


<message:QueryMessage xmIns="http:/Awww.SDMX.org/resources/SDMXML/schemas/v2_0/query" xmins:message="http:// 
www.SDMX.org/resources/SDMXML/schemas/v2_0/message" xsi:schemaLocation="http:/Awww.SDMX.org/resources/SDMXML/ 
schemas/v2_0/query http:/Awww.sdmx.org/docs/2_0/SDMXQuery.xsd http:/Awww.SDMX.org/resources/SDMXML/schemas/v2_0/ 
message http://Awww.sdmx.org/docs/2_0/SDMXMessage.xsd" xmins:xsi="http:/Awww.w3.org/2001/XMLSchema-instance"> 
<Header xmins="http:/Awww.SDMX.org/resources/SDMXML/schemas/v2_0/message"> 
<ID>none</ID> 
<Test>false</Test> 
<Truncated>false</Truncated> 
<Prepared>2012-06-01T09:41:13</Prepared> 
<Sender id="YourlD"> 
<Name xml:lang="en">Your English Name</Name> 
</Sender> 
<Receiver id="ABS"> 
<Name xml:lang="en">Australian Bureau of Statistics</Name> 
<Name xml:lang="fr'>Australian Bureau of Statistics</Name> 
</Receiver> 
</Header> 
<Query xmins="http:/Awww.SDMX.org/resources/SDMXML/schemas/v2_0/message"> 
<DataWhere xmins="http://www.SDMX.org/resources/SDMXML/schemas/v2_0/query"> 
<And> 
<DataSet>CPIl</DataSet> 
<Dimension id="REGION">50</Dimension> 
<Dimension id="FREQUENCY">Q</Dimension> 
<Attribute id="TIME_FORMAT">P3M</Attribute> 
<Time> 
<StartTime>2011-Q4</StartTime> 
<EndTime>2011-Q4</EndTime> 
</Time> 
<Or> 
<Dimension id="MEASURE">1</Dimension> 
<Dimension id="MEASURE">2</Dimension> 
<Dimension id="MEASURE">3</Dimension> 
</Or> 
<Or> 
<Dimension id="INDEX">10001</Dimension> 


<Dimension id="INDEX">20001</Dimension> 
<Dimension id="INDEX">20006</Dimension> 
<Dimension id="INDEX">20002</Dimension> 
<Dimension id="INDEX">20003</Dimension> 
<Dimension id="INDEX">20004</Dimension> 
<Dimension id="INDEX">115486</Dimension> 
<Dimension id="INDEX">20005</Dimension> 
<Dimension id="INDEX">115488</Dimension> 
<Dimension id="INDEX">115489</Dimension> 
<Dimension id="INDEX">115493</Dimension> 
<Dimension id="INDEX">126670</Dimension> 
<Dimension id="INDEX">999901</Dimension> 
<Dimension id="INDEX">999902</Dimension> 
<Dimension id="INDEX">999903</Dimension> 
</Or> 
<Or> 
<Dimension id="TSEST">10</Dimension> 
<Dimension id="TSEST">20</Dimension> 
</Or> 
</And> 
</DataWhere> 
</Query> 
</message:QueryMessage> 


2. GetCompactData 

This method retrieves data in a compact format from a specified ABS.Stat dataset. Similarly to 
GetGenericData method, it requires an input parameter (ie the query) as an XML document in SDMX-ML 
format and will return the query results in SDMX-ML format. 


3. GetDataStructureDefinition 


This method retrieves data structure definitions as well as codelists and concepts associated with a dataset. 
The input parameter is an XML document in SDMX-ML format and the output is an SDMX structure 
message (see Data Structure Definition Output example below). 


<message:QueryMessage xmlins="http:/Awww.SDMX.org/resources/SDMXML/schemas/v2_0/query" xmins:message="http:// 
www.SDMX.org/resources/SDMXML/schemas/v2_0/message" xsi:schemaLocation="http:/Awww.SDMX.org/resources/SDMXML/ 
schemas/v2_0/query http:/Awww.sdmx.org/docs/2_0/SDMXQuery.xsd 
http://www.SDMX.org/resources/SDMXML/schemas/v2_0/message http:/Awww.sdmx.org/docs/2_0/SDMXMessage.xsd" 
xmins:xsi="http:/Awww.w3.org/2001/XMLSchema-instance"> 
<Header xmIins="http:/Awww.SDMX.org/resources/SDMXML/schemas/v2_0/message"> 
<ID>none</ID> 
<Test>false</Test> 
<Prepared>2012-06-01T09:33:53</Prepared> 
<Sender id="YourlD"> 
<Name xml:lang="en">Your English Name</Name> 
</Sender> 
<Receiver id="ABS"> 
<Name xml:lang="en">Australian Bureau of Statistics</Name> 
<Name xml:lang="fr'>Australian Bureau of Statistics</Name> 
</Receiver> 
</Header> 
<message:Query> 
<KeyFamilyWhere> 
<Or> 
<KeyFamily>CPl</KeyFamily> 
</Or> 
</KeyFamilyWhere> 
</message:Query> 
</message:QueryMessage> 


SDMxX Data Structure Definition result example 
4. GetDatasetMetadata 


This method retrieves the metadata for a dataset for a specified dataset. It requires an input parameter (ie 


the query) as an XML document in SDMX-ML format. An example of the GetDatasetMetadata SDMX query 
message is copied below. The Web Service will return the query results in SDMX-ML format (see SDMX 
query result example below) 


<message:GenericMetadataQuery 
xmins:message="http:/Awww.sdmx.org/resources/sdmxml/schemas/v2_1/message" 
xmins:structure="http://www.sdmx.org/resources/sdmxml/schemas/v2_1/structure" 
xmins:query="http://www.sdmx.org/resources/sdmxml/schemas/v2_1/query" 
xmlns:common="http:/Awww.sdmx.org/resources/sdmxml/schemas/v2_1/common" 
xmins:xsi="http:/Awww.w3.org/2001/XMLSchema-instance" xsi:schemaLocation=" 
http:/Awww.sdmx.org/resources/sdmxml/schemas/v2_1/query SDMXQueryMetadata.xsd 
http://Awww.sdmx.org/resources/sdmxml/schemas/v2_1/message SDMXMessage.xsd"> 
<message:Header> 
<message:ID>REG_REQO007</message:|ID> 
<message: Test>true</message:Test> 
<message:Prepared>2012-06-01T09:48:05</message:Prepared> 
<message:Sender id="YourlD"> 
<common:Name xml:lang="en">Your English Name</common:Name> 
</message:Sender> 
<message:Receiver id="ABS"> 
<common:Name xml:lang="en">Australian Bureau of Statistics</common:Name> 
<common:Name xml:lang="fr'">Australian Bureau of Statistics</common:Name> 
</message:Receiver> 
</message:Header> 
<message:Query> 
<query:ReturnDetails/> 
<query:MetadataParameters> 
<query:AttachedDataSet> 
<common:DataProvider> 
<Ref id="ABS" maintainableParentID="" agencyID="ABS"/> 
</common:DataProvider> 
<common:ID>CPI</common:ID> 
</query:AttachedDataSet> 
</query:MetadataParameters> 
</message:Query> 
</message:GenericMetadataQuery> 


5. GetDimensionMemberMetadata 


This method retrieves the metadata for a particular dimension member for a specified dataset. It requires an 
input parameter (ie the query) as an XML document in SDMX-ML format. An example of the 
GetDimensionMemberMetadata SDMX query message is copied below. The Web Service will return the 
query results in SDMX-ML format (see SDMX query result example below) 


<message:GenericMetadataQuery 
xmins:message="http:/Awww.sdmx.org/resources/sdmxml/schemas/v2_1/message" 
xmins:structure="http://www.sdmx.org/resources/sdmxml/schemas/v2_1/structure" 
xmins:query="http://www.sdmx.org/resources/sdmxml/schemas/v2_1/query" 
xmins:common="http://(www.sdmx.org/resources/sdmxml/schemas/v2_1/common" 
xmins:xsi="http:/Awww.w3.org/2001/XMLSchema-instance" xsi:schemaLocation=" 
http://www.sdmx.org/resources/sdmxml/schemas/v2_1/query SDMXQueryMetadata.xsd 
http:/Awww.sdmx.org/resources/sdmxml/schemas/v2_1/message SDMXMessage.xsd"> 
<message:Header> 
<message:ID>REG_REQO007</message:ID> 
<message: Test>true</message:Test> 
<message:Prepared>2012-06-01T09:50:30</message:Prepared> 
<message:Sender id="YourlD"> 
<common:Name xml:lang="en">Your English Name</common:Name> 
</message:Sender> 
<message:Receiver id="ABS"> 
<common:Name xml:lang="en">Australian Bureau of Statistics</common:Name> 
<common:Name xml:lang="fr'>Australian Bureau of Statistics</common:Name> 
</message:Receiver> 


</message:Header> 
<message:Query> 
<query:ReturnDetails/> 
<query:MetadataParameters> 
<query:AttachedDatakey> 
<common:KeyValue id="MEASURE"> 
<common:Value>1</common:Value> 
</common:KeyValue> 
</query:AttachedDataKey> 
<query:AttachedDataSet> 
<common:DataProvider> 
<Ref id="ABS" maintainableParentID="" agencyID="ABS"/> 
</common:DataProvider> 
<common:ID>CPI</common:ID> 
</query:AttachedDataSet> 
</query:MetadataParameters> 
</message:Query> 
</message:GenericMetadataQuery> 


SDMX Query result example: 
6. GetDimensionMetadata 


This method retrieves the metadata for a particular dimension for a specified dataset. It requires an input 
parameter (ie the query) as an XML document in SDMX-ML format. An example of the 
GetDimensionMetadata SDMX query message is copied below. The Web Service will return the query 
results in SDMX-ML format (See SDMX query result example below) 


<message:GenericMetadataQuery 
xmins:message="http:/Awww.sdmx.org/resources/sdmxml/schemas/v2_1/message" 
xmins:structure="http://www.sdmx.org/resources/sdmxml/schemas/v2_1/structure" 
xmins:query="http://www.sdmx.org/resources/sdmxml/schemas/v2_1/query" 
xmins:common="http://www.sdmx.org/resources/sdmxml/schemas/v2_1/common" 
xmins:xsi="http:/Awww.w3.org/2001/XMLSchema-instance" xsi:schemaLocation=" 
http:/Awww.sdmx.org/resources/sdmxml/schemas/v2_1/query SDMXQueryMetadata.xsd 
http:/Awww.sdmx.org/resources/sdmxml/schemas/v2_1/message SDMXMessage.xsd"> 
<message:Header> 
<message:ID>REG_REQO07</message:ID> 
<message: Test>true</message:Test> 
<message:Prepared>2012-06-01T09:53:17</message:Prepared> 
<message:Sender id="YourlD"> 
<common:Name xml:lang="en">Your English Name</common:Name> 
</message:Sender> 
<message:Receiver id="ABS"> 
<common:Name xml:lang="en">Australian Bureau of Statistics</common:Name> 
<common:Name xml:lang="fr'>Australian Bureau of Statistics</common:Name> 
</message:Receiver> 
</message:Header> 
<message:Query> 
<query:ReturnDetails/> 
<query:MetadataParameters> 
<query:AttachedObject> 
<Ref package="datastructure" class="Dimension" id="MEASURE" agencylD="ABS'"/> 
</query:AttachedObject> 
<query:AttachedDataSet> 
<common:DataProvider> 
<Ref id="ABS" maintainableParentID="" agencyID="ABS"/> 
</common:DataProvider> 
<common:ID>CPI</common:ID> 
</query:AttachedDataSet> 
</query:MetadataParameters> 
</message:Query> 
</message:GenericMetadataQuery> 


7. GetMetadata 


This method is the generic method which can retrieve the metadata for a particular dimension member, 
datatset, dimension and reference metadata for a specified dataset depending on the input parameter. It 


requires an input parameter (ie the query) as an XML document in SDMX-ML format. 


See 5. GetDimensionMemberMetadata for an example of the GetMetadata SDMX query message and 
method results in SDMX-ML format. 


8. GetMetadataStructure 
This method retrieves the metadata structure definitions (code lists and concepts) for a particular for a 
specified dataset. It requires an input parameter (ie the query) as an XML document in SDMX-ML format. 


An example of the GetMetadataStructure SDMX query message is copied below. The Web Service will 
return the query results in SDMX-ML format (see SDMX query result example below). 


<message:MetadataStructureQuery 
xmins:message="http://www.sdmx.org/resources/sdmxml/schemas/v2_1/message" 
xmins:structure="http:/Awww.sdmx.org/resources/sdmxml/schemas/v2_1/structure" 
xmins:query="http://www.sdmx.org/resources/sdmxml/schemas/v2_1/query" 
xmins:common="http:/Awww.sdmx.org/resources/sdmxml/schemas/v2_1/common" 
xmins:xsi="http:/Awww.w3.org/2001/XMLSchema-instance" xsi:schemaLocation=" 
http://www.sdmx.org/resources/sdmxml/schemas/v2_1/query SDMXQueryMetadata.xsd 
http:/Awww.sdmx.org/resources/sdmxml/schemas/v2_1/message SDMXMessage.xsd"> 
<message:Header> 
<message:ID>REG_REQO07</message:ID> 
<message: Test>true</message:Test> 
<message:Prepared>2012-06-01T10:01:26</message:Prepared> 
<message:Sender id="YourID"> 
<common:Name xml:lang="en">Your English Name</common:Name> 
</message:Sender> 
<message:Receiver id="ABS"> 
<common:Name xml:lang="en">Australian Bureau of Statistics</common:Name> 
<common:Name xml:lang="fr'>Australian Bureau of Statistics</common:Name> 
</message:Receiver> 
</message:Header> 
<message:Query> 
<query:ReturnDetails> 
<query:References> 
<query:None/> 
</query:References> 
</query:ReturnDetails> 
<query:MetadataStructureWhere> 
<query:ID>LABOUR_PRICE_INDEX</query:ID> 
<query:AgencyID>ABS</query:Agency|ID> 
</query:MetadataStructureWhere> 
</message:Query> 
</message:MetadataStructureQuery> 


9. GetReferenceMetadata 


This method retrieves the reference metadata for a particular dimension member for a specified dataset. It 
requires an input parameter (ie the query) as an XML document in SDMX-ML format. An example of the 
GetDimensionMemberMetadata SDMX query message is copied below. The Web Service will return the 
query results in SDMX-ML format (see SDMX query result example below). 


<message:GenericMetadataQuery 
xmins:message="http:/Awww.sdmx.org/resources/sdmxml/schemas/v2_1/message" 
xmins:structure="http://www.sdmx.org/resources/sdmxml/schemas/v2_1/structure" 
xmins:query="http://www.sdmx.org/resources/sdmxml/schemas/v2_1/query" 
xmins:common="http:/Awww.sdmx.org/resources/sdmxml/schemas/v2_1/common" 
xmins:xsi="http:/Awww.w3.org/2001/XMLSchema-instance" xsi:schemaLocation=" 
http://www.sdmx.org/resources/sdmxml/schemas/v2_1/query SDMXQueryMetadata.xsd 
http://www.sdmx.org/resources/sdmxml/schemas/v2_1/message SDMXMessage.xsd"> 
<message:Header> 

<message:ID>REG_REQO07</message:|ID> 

<message: Test>true</message:Test> 

<message:Prepared>2012-06-01T10:03:45</message:Prepared> 

<message:Sender id="YourlD"> 


<common:Name xml:lang="en">Your English Name</common:Name> 
</message:Sender> 
<message:Receiver id="ABS"> 
<common:Name xml:lang="en">Australian Bureau of Statistics</common:Name> 
<common:Name xml:lang="fr">Australian Bureau of Statistics</common:Name> 
</message:Receiver> 
|</message:Header> 
<message:Query> 
<query:ReturnDetails/> 
<query:MetadataParameters> 
<query:AttachedDatakey> 
<common:KeyValue id="INDEX"> 
<common:Value>THRPEB</common:Value> 
</common:KeyValue> 
<common:KeyValue id="INDUSTRY"> 
<common:Value>-</common:Value> 
</common:KeyValue> 
<common:KeyValue id="REGION"> 
<common:Value>0</common:Value> 
</common:KeyValue> 
<common:KeyValue id="FREQUENCY"> 
<common:Value>Q</common:Value> 
</common:KeyValue> 
<common:KeyValue id="TIME"> 
<common:Value>2011Q4</common:Value> 
</common:KeyValue> 
<common:KeyValue id="MEASURE"> 
<common:Value>2</common:Value> 
</common:KeyValue> 
<common:KeyValue id="TSEST"> 
<common:Value>30</common:Value> 
</common:KeyValue> 
<common:KeyValue id="SECTOR"> 
<common:Value>7</common:Value> 
</common:KeyValue> 
</query:AttachedDataKey> 
<query:AttachedDataSet> 
<common:DataProvider> 
<Ref id="ABS" maintainableParentID="" agencyID="ABS"/> 
</common:DataProvider> 
<common:ID>CPI</common:ID> 
</query:AttachedDataSet> 
</query:MetadataParameters> 
|</message:Query> 
</message:GenericMetadataQuery> 
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“ \nformation for building a custom .Net application to call SDMX Web Service 


Below is general information on how to build a simple C# .NET application that calls the SDMX web 
services. 


Set up 

Set up C#.NET developer environment i.e. Visual Studio 2010 
Create C# project (application form or web application) 
Create a 'web references’ to the SDMX web service 
http://stat.abs.gov.au/sdmxws/sdmx.asmx 


Build an SDMX Query 

Create a function / method to build a SDMX query message specific to the SDMX web service call. The 
SDMX web service provides several methods where users can retrieve data from ABS.Stat. 

The available methods are: 


e GetGenericData 
GetCompactData 

e GetDataStructureDefinition 

e GetDatasetMetadata 

e GetDimensionMemberMetadata 
GetDimensionMetadata 

e GetMetadata 

e GetMetadataStructure 
GetReferenceMetadata 


Refer to each of the 'SDMX Query Message Example’ provided above for the structure of the query 
message to construct and pass onto the SDMX web service. 

Below is an example of C# code that builds the query messages which is then passed to the SDMX web 
service. 


Query_message builder for GetGenericData function: 


public static XmlElement GetGenericDataQuery(string dataSetCode, string senderCode) 


StringBuilder query = new StringBuilder(); 

query.Append(@"<message:QueryMessage xmlns=""http://www.SDMX.org/resources/SDMXML/schemas/ 
v2_0/query"" xmlns:message=""http://www.SDMX.org/resources/SDMXML/schemas/v2_0/message"" 
xsi:schemaLocation=""http://www.SDMX.org/resources/SDMXML/schemas/v2_0/query http://www.sdmx.org/ 
docs/2_0/SDMXQuery.xsd http://www.SDMX.org/resources/SDMXML/schemas/v2_0/message http:// 
www.sdmx.org/docs/2_0/SDMXMessage.xsd"" xmlns:xsi=""http://www.w3.org/2001/XMLSchema-instance"">"); 

query.Append("<message:Header>"); 

query.Append("<message:ID>none</message:ID> "); 

query.Append("<message:Test>false</message:Test> "); 

query.Append("<message:Prepared>2007-02-22T00:00:00-01:00</message:Prepared> "); 

query.Append(@"<message:Sender id=""ABS"" /> "); 

query.Append(@"<message:Receiver id=""" + senderCode + @""" /> "); 

query.Append("</message:Header>"); 

query.Append("<message:Query>"); 

query.Append("<DataWhere>"); 

query.Append("<And>"); 

query.Append("<DataSet>" + dataSetCode + "</DataSet> "); 


query.Append("<Time>"); 
query.Append("<StartTime>1900</StartTime>"); 
query.Append("<EndTime>2049</EndTime>"); 
query.Append("</Time>"); 
query.Append("</And>"); 
query.Append("</DataWhere>"); 
query.Append("</message:Query>"); 
query.Append("</message:QueryMessage>"); 


XmlDocument doc = new XmlDocument(); 
doc.LoadXml(query.ToString()); 


return doc.DocumentElement; 


Establish a web service connection to the server object 
i.e. OECDStatSDMXwebservice svc = new OECDStatSDMXwebservice(); 


Call the SDMX web service 

Pass the query message in XmIDocument format and store the output / result from the web service call as 
an xml element 

XmlElement xe = svc.GetCompactData(GetCompactDataQuery()); 


Pipe the element to where necessary 
i.e. Save to xml file use xe.WriteTo(XmlWriterPtr); 
where XmlWriterPtr is of type XmlWriter 
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” Frequently Asked Questions 


How do | know what datasets are available to download? 


How do | know what the dimensions\dimension members are and their respective codes fora 
particular dataset? 


Why do | get “500-Internal server error.” errors? 


Answers to Frequently Asked Questions 
How do I know what datasets are available to download? 


A complete listing of dataset IDs available to query can be retrieved via building a Dataset Structure 
Definition query message (refer to section 3) with no 'Key Family' metatags. Through calling the 
GetDataStructureDefinition web service and passing the DSD query message, a DSD output with a 
complete listing of datasets will be returned. 


How do | know what the dimensions\dimension members are and their respective codes fora 
particular dataset? 


By submitting a Dataset Structure Definition query message (refer to section 2.4.3) with a specific dataset 
ID, a list of dimensions and its associated dimension members are returned. In the below example (extract 
from CPI DSD) the ‘CodeList’ is the identifier for the dimension ‘Region’ (can be verified via the ‘Concept ID’ 
located further down in the DSD) and the ‘Code Value’ is the identifier for dimension member’s i.e. code 
value of 1 = Sydney. 


- <CodeList id="CL_CPI_LOC" agencyID="ABS'"> 
<Name xml:lang="en">CPI_LOC codelist</Name> 

- <Code value="1"> 

<Description xml:lang="en">Sydney</Description> 
<Description xml:lang="fr">1</Description> 

</Code> 

- <Code value="2"> 

<Description xml:lang="en">Melbourne</Description> 
<Description xml:lang="fr">2</Description> 
</Code> 

- <Code value="3"> 

<Description xml:lang="en">Brisbane</Description> 
<Description xml:lang="fr">3</Description> 
</Code> 


Why do | get “500-Internal server error.” errors? 


There is a 10 minute session time limit for users to download datasets from the SDMX Web Service. So any 
requests that require more than 10 minutes to download will result in a "500 - Internal server error." error 


message being returned to the user's application. Users should reduce the number of dataset variables 
requested i.e. rather requesting data from year 1900 to year 2012, request data from year 2000 to year 
2012. Should users require large amounts of data, try making multiple small SDMX requests to retrieve the 
data needed. 


Large datasets that users should be aware of and customise queries accordingly are: BA-GCCSA, BA-SA2, 
HF, IIP_DSID5671, LF, MECH_EXP, MECH_IMP, NRP7. 
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ABS.Stat Beta is a free interactive online tool that presents ABS data in a searchable, flexible and dynamic 
way. 


ABS.Stat has web services described in a machine-processable format using the Statistical Data and 
Metadata Standard (SDMX) allowing machine-to-machine processes for accessing and sharing ABS data. 


This user guide provides information on the use of web services, facilitating the sharing of data through a 
programmatic interface across the internet. 


The user guide will be updated from time to time as ABS adds further functionality to the system. 
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EXPLANATORY NOTES 


ABS.Stat web services allows the exchange of data between computer systems (the machine-to-machine 
services) facilitating the sharing of data through a programmatic interface across the internet. 


The machine-processable format used is the Statistical Data and Metadata Standard (SDMX). 


This allows machine-to machine mechanisms for accessing and sharing ABS data. 
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